home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d1 / diredit.arc / DIREDIT.HLP < prev    next >
Text File  |  1989-01-19  |  6KB  |  116 lines
  1. ***************** DIREDIT V1.51 ******************
  2.  
  3. This document outlines the functioning of DIREDIT, a program which allows the 
  4. restructuring of DOS directories, It is also used by the program itself as a 
  5. "Help File" and should be kept either in the current directory or in one 
  6. previously specified in a "PATH" command. The text may be edited, but the 
  7. lines which commence with a "$" sign should be preserved intact, since they 
  8. are used as index markers by the program. The lines which consist of single 
  9. "%" signs are used as page breaks when the file is displayed by the program 
  10. but have no other special significance.
  11.  
  12. $Command Line
  13. The program is invoked with the command:
  14.  
  15.                                DIREDIT [pathname]
  16.  
  17. If a pathname is not specified on the command line, the program will default 
  18. to the current directory. Any valid DOS path specification will be accepted 
  19. (e.g.  A:\; A:\SUB1\SUB2; \SUB1\SUB2 {referred to the root directory of the 
  20. current device}; SUB3\SUB4 {starting from the current directory}), but note 
  21. that the specification "d:" (where "d" represents any valid device name) will 
  22. be interpreted as indicating the ROOT directory of the specified device, NOT 
  23. the current default directory on that device. If the first file(s) in the 
  24. directory has(have) the "System" attribute, as is normally the case for the 
  25. first two files in the root directory of a bootable disk (IBMBIOS.COM and 
  26. IBMDOS.COM on IBM systems), you will be asked whether you wish to exclude them 
  27. from directory sorts - do not override the default (affirmative) answer to 
  28. this question unless you are absolutely sure you know what you are doing! 
  29.  
  30. $Spreadsheet
  31. The upper 20 lines of the terminal screen display "identifier blocks", 
  32. comprising a number (which initially corresponds (approximately) to the 
  33. position of the directory entry in the directory) and the file name, for 80 
  34. entries, in two semi-independently controllable windows, each of which 
  35. contains 40 blocks. If the directory happens to contain more than 80 entries, 
  36. the two windows can be positioned (using the <PgUp>, <PgDn>, <Home>, and <End> 
  37. keys) anywhere within it, except that they cannot overlap and that the left 
  38. hand window will always remain "below" the right hand one.  
  39. %
  40.  
  41.  <PgUp> moves the current window up by twenty quantities.
  42.  
  43.  <PgDn> moves the current window down by the same amount.
  44.  
  45.  <Home> moves the current window as far towards the file top as possible.
  46.  
  47.  <End> moves the current window as far towards the file bottom as possible.
  48.  
  49. If a window move would cause the two windows to overlap (i.e. the other window 
  50. is immediately adjacent in the direction of the attempted move) OR the windows 
  51. have been [L]ocked together, both windows are moved. If a window move would 
  52. cause either window to go beyond the top or bottom of the file, it does not 
  53. take place.  
  54. %
  55. The cursor can be moved to any identifier block by using the cursor keys, and 
  56. the "Cursor->" display at the bottom of the screen then shows the full 
  57. description of the file whose identifier is under the cursor. An entry is 
  58. moved by positioning the cursor on its identifier block, "picking it up" by 
  59. pressing the <Del> key, positioning the cursor at the point to which it is to 
  60. be moved, and "inserting" it there by pressing the <Ins> key. The full 
  61. description of an entry that is in the process of being moved is shown on the 
  62. "Moving->" display at the bottom of the screen. You may not exit (which 
  63. normally causes the disk directory to be updated) while an entry is being moved
  64. - you must replace it somewhere first. If you attempt to move an entry which 
  65. has the "System" or "Hidden" attribute, you will be asked to confirm the <Del> 
  66. entry before the program acts on it. A number of other single-key commands are 
  67. available - see the next screen for details.  
  68. %
  69. Additional single-key commands: 
  70.  
  71. "D" - change the date stamp on the current file.
  72.  
  73. "L" - toggle the "lock" which forces both windows to move together.
  74.  
  75. "M" - display the next line of the single-line "aide-memoire" list of commands 
  76. which appears on the 23rd line of the screen.  
  77.  
  78. "N" - edit a new directory (you are given the option of updating the current
  79. one first).  
  80.  
  81. "Q" - quit the program without updating the current directory.
  82.  
  83. "R" - rename the current file.
  84.  
  85. "S" - sort the directory (see next help screen).
  86.  
  87. "X" - exit and write the output file.
  88.  
  89. "?" or <F1> - display this help text again.
  90. %
  91. The directory display (and, ultimately, the directory on disk) may be sorted 
  92. by date, filename, extension, or file size, in ascending or descending order. 
  93. It may also be rearranged in any other order you care to specify. By default, 
  94. files with the "System" attribute at the beginning of the directory are 
  95. excluded from ALL sort operations. In fact, if you have moved one of these 
  96. files "by hand", performing a sort will result in its being returned to its 
  97. initial position. (continued...) 
  98. %
  99. When you enter "S", you will be prompted to indicate (by responding to a 
  100. series of questions) how you want the directory to be sorted.  
  101.  
  102. All the options after the first ("User-Specified Order?") should be self-
  103. explanatory - the first is the one that allows you to rearrange the file 
  104. entries in an arbitrary order. If you respond to this prompt with a "Y", you 
  105. will be prompted to enter two lists of file numbers (the numbers displayed 
  106. next to the filenames on the upper part of the screen). The first list should 
  107. contain the numbers of files which you would like to move to the top of the 
  108. directory (in the order in which you want them to appear there) - the second 
  109. should contain the numbers of files which you want to move to the bottom, also 
  110. in the order in which they are to appear. Either list may be blank (just press 
  111. <CR>). The lists should contain only the file numbers, as decimal integers, 
  112. separated by one or more spaces and/or tabs. Like all other sort operations, 
  113. this will, by default, leave system files at the beginning of the directory 
  114. untouched, EVEN if you specify their numbers in one of the lists you enter.
  115.  
  116.